home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1994 October / Macformat17.cdr / Shareware City / Developers / SC++ 7.0.3 Update / Release Notes / VA 7.0.3 READ ME < prev   
Encoding:
Text File  |  1994-07-11  |  9.2 KB  |  258 lines  |  [ttro/ttxt]
  1. Visual Architect 7.0.3 READ ME
  2. ==============================
  3. Copyright ©1994 Symantec Corporation. All Rights Reserved.
  4. June 16, 1994
  5. Font: Geneva 12
  6.  
  7. This file contains last minute corrections and additions pertaining
  8. to the Visual Architect application that are not described in the 
  9. Visual Architect/THINK Class Library Guide. The list of fixed bugs
  10. can be found at the end of this document.
  11.  
  12. •••••••••
  13. IMPORTANT
  14. •••••••••
  15.  
  16. In previous releases, it was not possible to have more than one
  17. document with Use File set. To fix this, it was necessary to change
  18. the name of the ItsContentsClass.h file to ItsContents_docname.h,
  19. where docname is the name of your document class. One of these
  20. header files is now generated for each document class that uses
  21. files. A CSaver_docname.cpp is also generated for each document
  22. window, again docname is the name of your document class that
  23. uses files. THIS WILL REQUIRE YOU TO CHANGE PROJECTS BUILT WITH EARLIER VERSIONS OF VISUAL ARCHITECT.
  24.  
  25. To convert projects created with earlier releases, you should
  26. regenerate your document (Main) view and manually transfer the
  27. changes you have made to the itsContentsClass.h file to the new
  28. itsContents_docname.h file. You can then delete the itsContentsClass.h
  29. file. You should also remove the CSaver_class.cpp and make sure the
  30. new CSaver_docname.cpp file(s) are added into the project.
  31. The project will then run as before.
  32.  
  33. NEW DOCUMENTATION
  34. ===================
  35. The (Supplementary Info) folder now contains the new file Using CSaver
  36. with CList.doc file, which explains how to use CSaver to open and save
  37. CList class lists of objects.
  38.  
  39. Tutorial Errata
  40. ==============
  41. The Beeper Tutorial (Chapter 5 of the Visual Architect/THINK Class 
  42. Library Guide) requires the following changes:
  43.  
  44. • On page 41, figure 4-5 should be:
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. • Also on page 41, Step 2 should read as follows:
  64.  
  65.  2. In the New View dialog box, type BeeperDialog in the field Name, 
  66.      select Modal Dialog from the View Kind popup, and click OK.
  67.  
  68.  
  69. • On page 43, Step 1 should read as follows:
  70.  
  71. 1.  Choose the Edit Text tool from the Tool Palette. Note that the cursor 
  72.    changes to a cross hair when it is over the dialog box. Click the cursor to 
  73.    the right of the static text pane you just added, to position the edit text pane.
  74.    An edit text box appears. Now press Return or Enter to edit the defualt static
  75.    text. Type the number "2", and then type  Enter a second time to finish
  76.    the edit task.
  77.  
  78.    You can constrain the type of text the user is allowed to enter into the edit 
  79.    text pane by selecting a special THINK Class Library class, as shown in the next
  80.    step. The edit text pane then becomes an instance of this class.
  81.  
  82. • In Chapter 6, the Process Monitor tutorial, p. 73: The first sentence of Step 2
  83.    should read:
  84.  
  85. 2. Choose Pane Info from the Pane menu (Command-L), or double-click the button
  86.    pane.
  87.  
  88.  
  89. Converting from Classy to Visual Architect
  90. =======================================
  91.  
  92. Visual Architect can read existing Classy resource files, however a few steps 
  93. must be taken to properly convert all of the view information. These steps are:
  94.  
  95. 1. Open the Classy Resource file using Visual Architect
  96. 2. For each view, do the following:
  97.     a. Open the view
  98.     b. Modify the view in some trivial way. The easiest thing is to do a Select All
  99.         (command-a) and then move all the panes one step to the left, and then back
  100.         one step to the right by pressing the left and right arrow keys, respectively
  101. 3. Select Save from the File menu to save the converted resource file
  102.  
  103.  
  104. Common Mistakes
  105. ================
  106.  
  107. When working with Visual Architect, keep in mind that it creates two 
  108. "levels" of files for your application. All files that begin with "x_" are
  109. files that are modified as needed by Visual Architect. You should NOT make
  110. changes directly to any of the "x_" files, since Visual Architect will just 
  111. overwrite that file. Any user changes should always be in the upper level 
  112. files.
  113.  
  114.  
  115. Automatic Window Closing
  116. ========================
  117.  
  118. Anytime that Visual Architect generates a file, it will check with the THINK
  119. Project Manager to see if that file is open in the Editor. If it is, Visual 
  120. Architect will ask the THINK Project Manager to close the window. As a result, 
  121. you will notice from time to time that editor windows showing lower layer ("x_")
  122. files are automatically closed during the generate phase of Visual Architect. When 
  123. the generate phase is complete, you can again open any lower layer files in the
  124. THINK Project Manager's editor.
  125.  
  126.  
  127. File IDs in the Application Info dialog
  128. ==================================
  129.  
  130. Visual Architect's Application Info dialog (opened by choosing Application from
  131. the Edit menu) allows you to specify File IDs that the application will use. Keep in 
  132. mind that these IDs must be four character constants like 'doc1' or 'MyDc'. If you 
  133. don't enter four character, Visual Architect will display a validation dialog to 
  134. remind you.
  135.  
  136.  
  137. Using Hierarchical Menus
  138. ========================
  139.  
  140. When you create a menu item that has a hierarchical submenu attached, 
  141. that menu item will have cmdNull assigned as its default command by
  142. Visual Architect. Because of the way that the THINK Class Library enables
  143. menus, this means that the menu item containing hierarchical items will
  144. be disabled, even if some or all of the hierarchal items should be 
  145. enabled. To cause the menu item to be enabled, you need to create a dummy 
  146. command handled by the appropriate view or application class. Then assign 
  147. this command to the menu item containing the hierarchical menu. 
  148.  
  149. For example, if there is to be a menu item called 'Foo' in the File menu 
  150. that has a hierarchic menu that should be enabled when the 'Main' document
  151. is active, follow the following steps:
  152.  
  153. 1.  Create a new command named cmdDummyFoo
  154. 2.  Set the In Class: pop up for the command to be CMain
  155. 3.  Set the command action to "None"
  156.  
  157. Now the Foo menu item will be enabled any time a 'Main' document window
  158. is the frontmost window.
  159.  
  160.  
  161. Creating Multiple Columns for CArrayPane Derived Classes
  162. =====================================================
  163.  
  164. When creating CArrayPane panes in Visual Architect, you cannot specify the
  165. number of columns in the Pane Info dialog. To create a multi-column table,
  166. you can use the  following technique in your CArrayPane's GetFrom() member
  167. function:
  168.  
  169. void    MyArrayPane::GetFrom(
  170.     CStream     &aStream)
  171. {
  172.         // Get any additional data members for this class
  173.         // before calling the superclass GetFrom
  174.  
  175.  
  176.                                         /* Let superclass restore            */
  177.     x_MyArrayPane::GetFrom(aStream);
  178.  
  179.   // Next three lines of code set up a multicolumn table
  180.   DeleteCol(1,1);              // One column is automatically created, we delete it here
  181.                                        // so that default column width will be honored
  182.  
  183.   AddCol(someCols, -1);       // someCols is the number of columns for your table
  184.   AddRow(someRows, -1);    // someRows is the number of rows for your table
  185.  
  186.         // Restore any subordinate objects below
  187.  
  188. }
  189.  
  190. Bugs Fixed in Visual Architect 7.0.3
  191. ================================
  192. • Popups and tearoffs are now initialized with their resource ID as
  193.    part of the title, so users can better distinguish them when editing.
  194.  
  195. • Now checks for output file names > 31 characters during generation.
  196.  
  197. • Zero values now displayed and edited correctly in top, left, width
  198.    and height of Pane Info dialog.
  199.  
  200. • Popup panes with derived classes no longer crash Pane Info dialog.
  201.  
  202. • VA macro files now permit more than one document of Use File (CSaver) type.
  203.  
  204. Bugs Fixed in Visual Architect 7.0.1
  205. ================================
  206.  
  207. • Cmd-U is now used exclusively for Bring Up To Date (like TPM)
  208. instead of Underline.
  209.  
  210. • Balloon Help is now disabled in menu dialogs.
  211.  
  212. • The Tools menu is now deactivated when a TearoffMenu is in front.
  213.  
  214. • CPane height, width, hEncl and vEncl now show their correct values
  215. when pane is enclosed in a scrollpane. This allows users to change
  216. the pane size and offset.
  217.  
  218. • The Tools palette is now hidden and the Tools menu disabled when a
  219. Pane Info window is frontmost.
  220.  
  221. • If you Generate All then Run, VA won't generate again.
  222.  
  223. • VA now asks TPM to close and mark changed all generated header files.
  224.  
  225. • Comments in generated files now refer to .cp instead of .c files.
  226.  
  227. • Cmd-I no longer changes the size of CEditText items. 
  228.  
  229. • CShapeButton unhilites appropriately.
  230.  
  231. • VA-defined data members of type long can now be properly set in
  232. Pane Info.
  233.  
  234. • Pane Info is no longer enabled when a view is selected in the 
  235. document window.
  236.  
  237. • Unchecking "use file" for a document now generates compilable
  238. code.
  239.  
  240. • Identifier in Pane Info is now validated to be <= 31 characters,
  241. a valid C identifier and unique within the view.
  242.  
  243. • Entering duplicate command names is not allowed.
  244.  
  245. • Changing the class of a pane while its Pane Info dialog is open
  246. dismisses the dialog (instead of scrambling it or crashing).
  247.  
  248. • The Pane Info for CArrayPanes no longer includes the number of
  249. columns.
  250.  
  251. • Deleting a view now forces a Generate All. (The user must still manually
  252. remove the view class from the project, if necessary, but other generated
  253. files will not refer to the class.) If a file is closed with a Generate
  254. All pending, it will be remembered when the file is reopened.
  255.  
  256. • Opening a file will fail if the file was written by a later version of VA.
  257.  
  258.